.. _cemIxMapAxes:

cemIxMapAxes
============
------------


SYNOPSIS
--------


.. code-block:: none

  LONG cemIxMapAxes(
    LONG MapIndex,
    LONG NodeID,
    LONG MapMask1,
    LONG MapMask2
  )



DESCRIPTION
-----------


- cemIxMapAxes 함수는 보간 작업을 수행할 축들을 맵 번호(Map index)로 맵핑(Mapping) 합니다. 
- 맵 번호는 다른 “기본보간제어”에 관련된 함수들의 첫 번째 매개변수로 전달됨으로써 각 보간 함수들이 제어해야 할 축들에 대한 정보가 간편하게 전달됩니다. 
- 따라서 다른 “기본보간제어”에 관련된 함수들을 사용하기 전에 가장 먼저 이 함수를 사용하여 “기본보간제어”에 사용할 축들을 맵핑 하여야 합니다.



PARAMETER
---------


- MapIndex : 맵 번호(Map index). 맵 번호는 반드시 0 ~ 15 안에서 설정하여야 합니다. 

- NodeID : 원격 노드 ID. 보간 제어를 수행할 원격 노드의 ID 를 설정합니다. 

- MapMask1 : 축 맵에 포함할 축들을 지정할 마스크 값(하위 32 비트, BIT0 ~ BIT31). . 

- MapMask2 : MapMask2 : 축 맵에 포함할 축들을 지정할 마스크 값(상위 32 비트, BIT32 ~ BIT63). 




RETURN VALUE
------------


+----------------+--------------------------------------------------------+
| Value          | Meaning                                                |
+================+========================================================+
| 음수           | 수행 실패. 자세한 내용은 ‘에러처리’ 편을 참고합니다. |
+----------------+--------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공.                                             |
+----------------+--------------------------------------------------------+



EXAMPLE
-------


C++
^^^


.. code-block:: c++
  :linenos:
  :emphasize-lines: 

  C/C++
  #include “ceSDK.h”
  #include “ceSDKDef.h”
  #define MAP0 0 // 보간 맵 번호
  /* 다음과 같은 2 개의 원격 노드가 존재한다고 가정합니다.
  Node Master 1 : NodeID = 1, 16 Axes
  Node Master 2 : NodeID = 2, 8 Axes
  통합 축 번호 16 번, 17 번 축을 대상으로 보간 맵 설정을 수행합니다.
  보간 제어는 원격 노드안의 제한된 통합 축 번호로 관리되므로, 2 번째 원격 노드에서의
  제한된 통합 축 번호인 0 번, 1 번 축을 MapMask 로 설정하여야 합니다. */
  // 2 번 노드에 있는 0 번 축과 1 번 축을 하나의 맵으로 묶습니다.
  cemIxMapAxes ( MAP0, 2, cemX1_MASK | cemY1_MASK, 0 );
  // 또는 cemIxMapAxes ( MAP0, 2, 0x3, 0x0 );
  // MAP0 로 묶여 있는 축들을 해제 합니다.
  // cemIxUnMap ( MAP0 );



.. seealso::
  :ref:`cemIxUnMap`